Subsystem constructor 1

A creator for the Subsystem class. This class contains the necessary information about controlling the KINGSTAR library.

Namespace: IntervalZero.KINGSTAR.OpcUa.Class

Assembly: IntervalZero.KINGSTAR.OpcUa.Class (in IntervalZero.KINGSTAR.OpcUa.Client.dll) Version: 4.4.0.0

Syntax

C#VB
public Subsystem(
       string configurationFile,
       int idealProcessor = 0,
       int instance = 0,
       int updateInterval = 50,
       ushort defaultCertificateLifeTimeInMonths = 120,
       ushort certificateRecreationThresholdInMonths = 60
)
Public Sub New(
       configurationFile As String,
       Optional idealProcessor As Integer = 0,
       Optional instance As Integer = 0,
       Optional updateInterval As Integer = 50,
       Optional defaultCertificateLifeTimeInMonths As UShort = 120,
       Optional certificateRecreationThresholdInMonths As UShort = 60
)

Parameters

configurationFile

Type: string

The location of the .kst file, which is created using KINGSTAR Configuration Tool.

 

idealProcessor [optional]

Type: int

Default value: 0

Configures which core the KINGSTAR Subsystem runs on. All threads of the Subsystem run on the given processor. Core Zero is always for Windows. Other cores can be assigned to the Subsystem depending on your settings. By default, IdealProcessor is set to zero, meaning KINGSTAR will use the ideal processor configured in the instance configuration table (Control Panel > Runtime Settings > General Settings). If the table lacks settings for the given instance, the Subsystem may run on any core available to RTX64. If you set it to another number, such as two, the Subsystem will take the Core Two.

 

instance [optional]

Type: int

Default value: 0

Selects which KINGSTAR Runtime instance you want to use when you have Multiple Master Package. If you don't have the package, set it to zero (0); if you have the package, the valid instance should be: 0 <= instance <= 63. The instance can be set according to your needs, for example: if you have three instances and want to use the third one, set it to two (2).

 

updateInterval [optional]

Type: int

Default value: 50

How long the Subsystem, axes, I/O modules and all other devices update their status. The default value is 50 milliseconds.

 

defaultCertificateLifeTimeInMonths [optional]

Type: ushort

Default value: 120

Sets the default certificate lifespan in months for the KINGSTAR OPC UA client's automatically generated self-signed certificates. Please refer to Certificate Management for more information.

NOTE:  defaultCertificateLifeTimeInMonths is supported for KINGSTAR 4.5 and later versions.

 

certificateRecreationThresholdInMonths [optional]

Type: ushort

Default value: 60

Specifies the time in months before expiration when the constructor will trigger certificate regeneration. Please refer to Certificate Management for more information.

NOTE:  certificateRecreationThresholdInMonths is supported for KINGSTAR 4.5 and later versions.

See also

Subsystem Class

IntervalZero.KINGSTAR.OpcUa.Class Namespace